home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / knew300.arc / KNEW3.DOC < prev   
Encoding:
Text File  |  1986-01-29  |  6.5 KB  |  166 lines
  1.  
  2.                  KOPYNEW - Version 3.00
  3.  
  4.  
  5.     Format:    KNEW
  6.            KNEW S: T:
  7.            KNEW S:FILE.NAM T:
  8.  
  9.     Flags:       /p - do not pause for swapping of diskettes
  10.  
  11.           KOPYNEW or KNEW copies files from the source drive
  12.      to the target drive if the files have a newer time and date on
  13.      the source or if they are new files on the source drive. The files
  14.      that are copied have the same date and time as they did on the
  15.      source directory.
  16.  
  17.           For example, if there is a file `FILE1.NAM'  dated 10/09/84
  18.      on the source and a file `FILE1.NAM' on the target dated 10/08/84,
  19.      then `FILE1.NAM' would be copied.
  20.  
  21.           If `FILE1.NAM' on the source is dated 10/09/84  with the time
  22.      09:30 am and is dated 10/09/84 on the target but with the time
  23.      stamp of 06:00 am, then it would be copied to the target.
  24.  
  25.           If `FILE1.NAM' is found on the source but not on the target,
  26.      it would be copied.
  27.  
  28.      NOTE: As KOPYNEW uses the time and date stamp from the directories
  29.      to check to see if the source drive has the newer file, the time
  30.      and date must be reasonably accurate. If you do not have a clock
  31.      calendar on you machine, you must set the time and date manually
  32.      or KOPYNEW will not work correctly.
  33.  
  34.      DEFAULTS:
  35.  
  36.           If no drive designators are given, drive C is the
  37.      source and drive A is the target. Otherwise drive S is
  38.      the source and drive T is the target. The drive designators
  39.      must be in the range A to F or a to f.
  40.  
  41.      FILENAMES:
  42.  
  43.           Standard DOS file names are acceptable for the source drive.
  44.      Wild card characters can be used. There is no facility to accept
  45.      file names for the target drive. Files are copied to the target
  46.      drive and are given the same name as on the source drive. If no
  47.      file name is given, all files are copied. That is, KNEW S: T: and
  48.      KNEW S:*.* T: are equivalent.
  49.  
  50.      FLAGS:
  51.  
  52.           Flags can be added to any of the calling formats. For
  53.      example, KNEW will copy all new or updated files from drive C to
  54.      drive A. KNEW /p will perform the same copy but it will not stop
  55.      and prompt you to insert the diskettes.
  56.  
  57.  
  58.      STATUS MESSAGES:
  59.  
  60.           S:FILE.NAM Copied - file is newer on the source drive so
  61.                   KNEW copied it to the target drive.
  62.  
  63.           S:FILE.NAM Not Copied - file has the same date and time or
  64.                   is newer on the target drive so it is not
  65.                   copied.
  66.  
  67.           S:FILE.NAM Deleted - file is newer on the source drive so
  68.                   KNEW tried to copy it to the target drive.
  69.                   The copy failed so the file is deleted
  70.                   from the target drive. The file on the
  71.                   source drive is intact.
  72.  
  73.           S:FILE.NAM Created and Copied - file is on the source drive
  74.                   but not the target drive. The file is
  75.                   copied to the target drive.
  76.  
  77.           S:FILE.NAM Created and Deleted - file is on the source drive
  78.                   but not the target drive. The copy
  79.                   failed so the file is deleted from the
  80.                   target drive. The file on the source
  81.                   drive is intact.
  82.  
  83.      OTHER MESSAGES:
  84.  
  85.           Invalid Drive Specification - Drive x
  86.           Drive letters from A to F are acceptable
  87.  
  88.           where x is the invalid drive specification.
  89.  
  90.           Drive or file information not clear
  91.  
  92.           The information on the command line is not clear. Probably,
  93.      the first drive designator or the colon was omitted.
  94.  
  95.           Open Failed for Input File
  96.           Open Failed for Output File
  97.  
  98.           The input or output file could not be opened for some reason.
  99.      Use COPY S:FILE.NAM T: to copy the file that could not be copied
  100.      by KOPYNEW. There could be a problem with the file directory.
  101.  
  102.           All other messages are the same as the Error Return Table
  103.      in the DOS 2.0 manual, appendix D, page D-14. If an unknown
  104.      error code is returned to the programme by DOS, the  message
  105.      `Unexpected Error' is displayed.
  106.  
  107.      SUGGESTED USES:
  108.  
  109.           KOPYNEW was originally written to be used with ram disks. I
  110.      develop software using a ram disk to hold my Macro Assembler, my
  111.      Linker, my editor and the programme source. As I write in
  112.      assembler, I tend to hang my computer frequently. Therefore I
  113.      always had to copy the programme source, the assembled
  114.      programme and any other files that I did not have a current copy
  115.      of onto a floppy just in case I hung my computer. COPY C:*.* A:
  116.      works but it is slow. KOPYNEW is much faster as it only
  117.      copies new or updated files.
  118.  
  119.           I have also used KOPYNEW in an environment that included a
  120.      regular hard disk with a removable cartridge disk for backup.
  121.      As this was a large dBase II project with over 200 programmes and
  122.      database files, keeping track of which programmes and files had
  123.      been changed during the day become quite difficult. Copying only
  124.      the new or updated files using KNEW C: D: was much faster than
  125.      using COPY C:*.* D:.
  126.  
  127.           I have used KOPYNEW with a Tecmar ram disk, a Tecmar 33
  128.      megabyte hard disk with a 5 megabyte removable cartridge and on a
  129.      Tallgrass 12 megabyte hard disk. I used standard DOS 2.0 function
  130.      calls throughout so that KNEW should work with any hard disk that
  131.      works with DOS 2.0 or higher. If you have any problems, please
  132.      contact me. See below.
  133.  
  134.     VERSIONS:
  135.  
  136.           KOPYNEW Version 1.00 was a basic copy utility that used
  137.     the time and date stamping on the files to determine if a file
  138.     should be copied.
  139.  
  140.           KOPYNEW Version 2.00 added flags for turning off the pause
  141.     for disk swapping, the file by file listing and the copy summary
  142.     at the end of the programme. Version 2.00 also added file name
  143.     selection that allowed for both the `?' and `*' wildcard
  144.     characters.
  145.  
  146.           KOPYNEW Version 3.00 omitted the file by file listing flag
  147.     and the summary flag. The display now uses a window on the left to
  148.     list the files and a window on the right side of the screen to display
  149.     the copy summary while the programme is running. Version 3.00 also
  150.     pauses when the target disk is full.
  151.  
  152.           KOPYNEW Version 3.10 is much smaller. In addition, a batch
  153.      file is included to help people patch KOPYNEW to use different
  154.      default drives. REVISE has its own instructions. It does need
  155.      DEBUG.COM available in the same search path as REVISE.BAT and
  156.      KNEW3.EXE.
  157.  
  158.           KOPYNEW Version 3.00 is copyrighted. It is, nevertheless,
  159.      public domain software. If you have any comments or suggestions,
  160.      I can be reached through the PCanada Bulletin Board (PC1049) or
  161.      through the CompuServe Network (72365,301). Alternatively, my
  162.      telephone number is 1-416-889-1409.
  163.  
  164.                             Glen C. Siegel
  165.                                February 15, 1985
  166.